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The materlal Included Tn this funct|sna| 
SpeclflcatTon, Including but not |lmlted 
to,  [nstryctlan tliees and onerating 
Speeds Is for Information nuroncses only, 
Al{ sucn material [TS Suaject to change 
without notice, .Concaquently GEC makes 
no clalm and shal] not pe |fandle for |ts 
Accuracy, 


Unless Soecified otherwise, tne terns 
"RSX" and "RSxXeiii imo ty "ROXe1 iN", 
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INTRODUCTION 


_ FagqeruwvsTe awa 
¢ 


Task Instaljatlon wll] cons}]st of twe taskls, The Task 


Bullder wlll aerforn tna linking of tre task anc optionally 
Instajl tne task, Instaij wili [mstal| a task [nto the 


System that has deen dylit by the Task sullder, 


The Task Guilder [s an Interactive MCR funnies that 
relocates and I{nks objact modules, usar lisrary’s ands 
Global Comvon's, The TasK gulilcer als. allocates te  yser 
AS?ES anc estaojlsnes the userls Pee eaNee ses, default 
prlor|[ty and, deafaylt nartit{ons, ; 


Insta|| Is an mor function that enters a task that has een 
buJit by the task oyliacer jnte tna rsxatid Systenrn, Install | 
Optional|lly astanl|snes =n, user'!s qefault martition ang 
Gefau|t priority, a 1 


Task Byullolng of an RSX#115 Task - the process ef cpeating 
@ contiguays Task Image on a disk and Optianailty an entry tn 
the System Task Olreectory, from ralecatand(a 29Ject morules, 
 Thase tast!s can be USer Pragrams, “CR Function Task!'s ar 
“170 Handler Taskis, | : : 


: Tne following Is a |Tst of the major ooeraticons rectulraz to 
.eulld ao task, They ara jisted In tre orcer jn wnichr tansy 
are verforvedi : 


1, Alfocates af[Sx Storage for the user task wftr 
the task name as the fFija mame ang finss 4 free 
Systen Task uUJrectory entry |f tne task js te Ge 
Installed, | 


2, Alfocates ASR*s far Giobaj Common and: System 
Lists#, eo 


S$, neads abysct modules and refocates geaneratina 
a memory naga on a als, 


4, Ganditlonal|y Rejecates rout(res from the User 
Library, 


5. Conditionally Links to mamory Res{[déant L]trary 
routines, 


Y 


®@ em only opty] ledcqad task’s are provided access 
to List‘s, Tabjes, System Syoroylnas, ana External 
Page, | 
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6, Conditionally rejocates. routines. from the 
Systen Library, | 


(Rejocation [s |n Ts |ncreas{ng virtyal memory,) 


CONTROL STATMENTS 


*eguenencorenawe 


Tna following Is a Geser|pt{on of thea Task Qulider Control 
Statments, The Syntax Is aeflned [In mod{flea BNF using the 
fol jow!ng conventions and definitions: 


Angle prackxets delim[t metal]ngulstic varlabjes, 
Quote marks del]mit a character string, 
A slasn (7) [nafcates alternation (92), 
NO op®rator |ndf[cates concatenatlin, 
Parens [ndjcate factoring, 

CARKAGE RETUTN [mplies |Inea continuation necessary 
ALTHCDE Inolles no continuatlon nesessary 

‘$f [ndlcates any number Cilncluding zero] Of, 
(NUL! [ndlcateS the ampty set, | 
<8C> ty= Space or Blank Of cotna 


WE Pe WLELOLS CELT CPL ELPA UPL LPL Le : 


£OIGiT> iis 

CLETTERS FES MAPZEShS"C™ slewe stuns ERNST NSIS 

QCNAMED 33s So Neston TTERD/S<KOIGITD) ; 

CORD Pes CARKAGE PETURN 

€AM> T3= ALTMIOE 

€TOD> Sse KORI/<AND 

EqNBC> 345 Non Beoanw Character 
Insta]! Ts an MCR Function task that Inserts a tes Into the 
Systen Task Dlrectory, Tha Task ijame Is the flle rama, The 
Task wane, ODefayls Partition, and Yefaul]t gsriertty are 


speclfled In the fojsowf[nyg syntax? 


MCH SYNTAX ats "ENS"SCNGT> CSC> <TASK NAMED <&CD 
CUEFAULT PARTITION NAME> “UTD KCEFAULT PRIGPITY> <TO>y7 
TASK NAME > $35 SNAMED; 
<UEFAULT PARTITION> ties <NAMED} 
CDEFAULT PRIORJTY> 35 <DECIMAL VALUED] 


EXAMPLE} 
MCR, IS: JOE,PAR, 4d 
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The Task syullder Is an MCR Fuact{on Tasks the task nama, 
Gefau([t partitjon and dafault prlorTty are Specifjed In tne 
following “CR Function syntax} 


MCR SYNTAX $25 "TKBANECNECD K€BC> <TASK NAMED <8CD> 
CQEFAULT PARTITION NAME> <3C> <DEFAULT PRIORITY NUMAERD 


<T0>3 « 
<TASK NAMED te “NAMED 
CDEFAULT PARTITION NAMED 


ts CNAMED; 
<DEFAULT PRIORITY NUMGERD 43 


= <DECINAL VALUED) 


EXAMPLE} 
MCR, TKB JOE,PAR, 476 


TASK MAME we ASX Task‘s are  [dentifled by ‘ames 
that are spaclifled wnen the Tas*s are [nstallea, 
Trese names apa [nascendant of orogran cr fifa 
names, Task Names are the nanes cf the tasks 69 
be Jnctajlad, This wif bea tne name shat is 
Inserted In the System Task Directory (ST), 


DEFAULT PARTITION w= Dafaujt Partitilon Its the 
memory partitlon In whfan the task wf{lf run ite 
soecif{calily noverrldgen whan the task! S axecytio 
iS reagyested, . 


DEFAULT PRIOGRITY -- Cefayjt Prlortty Is tna 
orlerity unger which tha Task «jI] run uniass a 
partit{an is speclfiles wnen tre Task's axecgytion 
{Ss recuested, 


After The Task Bulider nas yalf{dated tre “CR commang jine It 
wid] wt] outout prompting Symbols and accept respanses as 
descr|Sed below, 


OPTIONS 


Paquvewe 


Tre Task Sullcar wl} tyre an "“OoPTIONS:" Dee URS sy pol 
and accent rasnonses of the followng syntax, 


OPTIONS t 32 EC <GPTICN> 4 <TO> 93 
<OPTIGND s32 <OFTICN SYMRCLO <TERMINATORD 3 


Pounwaewosnwncee 


Bowe WHEN PATCH IS IMPLEMENTEU, THE TASK EUILOER 
WILL OPERATE UNDER BATCH AND NOT YODER MTR, 
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Cootlon symDo|> 3s “ptn/Mnnmsnszmsmephyent™ sein | 
-€termi(nator> sts <top / <Spacee Seen tees) 


examo |e - 
opt{fons! 
optfonstpt,nm,S2,.¢p 


Tne option symbols have the followIng mean|ngs? — 


JN ew. [nsert an entry for th[s task In the System. 
Task Ojrectory (STO), | ae 


¢ 


NF ew declare thTs task to be a task that an not. 
use tha floating polnt unit). 


PT we A Priviledaad Task [s a task that nas 
Exacut[ve capabi|!itles,; ang Is trysted nat tn 
endangoar the system,  J/0 dandlar Task’ s and soma 
-MCR Functjon tasx’s reoulrea tris erlvileace [n 
~—Order to access tne PoPe1t External Pace and 
~$Systen Subrouti{nes, of System Tadles and Lists, 


NM «= No load map prevents the |coaq mao fron belne 
printed as the task |s he]ng !Inkeaq, Thea Task 
~—6Bullaer program narnal|y prints tre |oae man, | 


SZ w- Size of task, This ontlon cause the size of 
the user task to be orfnted after It has bean 


CP w= ChesxootTntar|3 tasK, | ThI]s options causes 
tre d]sk allecation for chackpol[ntina anc Pormits 
the task to request checKoo[nting, 


STACK 4REA 


Cwvecvescae 


Stack Soace [Ts alincatec [rn Increasing memory from virtual 
Tocaton to (¢yIrtual Zero |S always used for Ulrective 
Status), with tne Task’s Stack Pofmter set %o tha maxfaum 
address +2, The StacK Area {sS free “A7t0rPy any need “UT he 
used exelus|valy for Stack storage, 


Tne Task Bullder oytputs a “STACK” aramntinai symhol and 
“accents a fesponse of tna foljowlng syntax! 


STACK AREA Sts (<POSITIVE DECIMAL VALUCD/NUL) <TC); 
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Tfono Stack siza Is Sspec|fjed, an area cf 31 words Is 
aj located, | ; : "3 


~Exampjesi 
STACK{75 
STACK] 
STACK {2 
POOL LIMIT 


VFaewrsartnanwe 


Pool LIMTt [s the number of Poo| Nodes tnat "ay be Jr use hy 
a Task at any one t1"8, If no Fool Lint* Is snecifles a 


 Gefaul[t poe| Jimit of flvye nedes wif! be ajlocated, The 


— Task Puliter outouts a "POOLE" prompting symoo| ang accects 
@ pesponse of tne following syntax} 


POOL LIMIT i: (POSITIVE DECIMAL VANED/NUL) <TC>} 


EXAMPLE} 
POOLI4a 
POOLS 


USER LIB 


User LI paquests the Inout of the name of tee user I}hrarve 
If any, to oe specifies, The Task dullder will tyce "USER 
LgSe"’ and accent a user Library nate |n tne following 
 Syntaxt | 


USER LIB NAM 3 


C<LIGRAPY NAMED JNUL) <TO> a 
CLIBRASY NAM $45 


E> CHAMED} 
EXAMPLES 
USER LTStL1eR 
USER LISI 


Tne Yser Library Name ts aotinnal and ft wlll cause an 


Indicated user provided |lbrary to Pe Seannsad (to satisfy 
unresolyeq gjobal synoo|] ruferences) Geforfe ary atner 


I{orery |S SsGanned, Routines fron a User CLlbrary are 
Pelasated and Inc|yqed as a part of tne Task jaad image, 


GLOBAL COM 


TASK INSTALLATION PAGE. 7 


Tne Gjoba|. Common Js used for Inter-Task communications and 
extraeTask data Storage, Install may be |nstructed to map a 
' Taskts references to elements of a "mamed Coanmmon Into a 
Globa| Common of tne Same name, wiltn elter reaawoniv or 


~ fPead/we|[te accass, Tha Task Bullder will tyne "GEOGAL SAK" 


-and accent Gjobal Common names |[n the following syntax} 


GLOBAL COM 33s “COMMON NAME> (4 7°<COMMON NAMED) 
) (<ACCESS COUF> /NUL) <TC>; 

<COMMON NAME> tis <NAMED] 

SACCESS CONE> tte "ROWZIRWNY 


EXAMPLE: 
GLOBAL COMsCOMA/RA 
GLOBAL COM} neve 


Each Global Common referenced reaulres one ASR for each 4K 
of storage araa, a . 


NUM LUNS 


Cuywpewastaw:: 


‘The recuest Nun LU‘s specifies the nynter of LUNS that will 
he .atlocated te a task, Tne Task syulider wll] tyoe "REM 
LYNSOt' ana accept the numpsr. of Luts In tne following 
Syntax Ry 


NUM LUNS ffs <OCTAL VALUED <TC>; 


EXAMPLE! 
NuM LUNS?#S 
NUM LUNSI 


DEFAULT ASSIGNMENTS 


SQeqgevetguwuwa@awwerartw ga @ 
+ * is . 


Defau|jt AsS[gnnents allows a Task's LUNs t9 de oOrfaass!lGned, 
Any Lu“s not assigned will default to "none" (unassigned), 


Any number of Asslanmants may 66 used, If.a LUN Js assigned 
to 8=mora than one physical deviceeynit, the latter 
assian™ents ara consideréd rerassiynments, and the last 
assignment fs wand as tna cefaulst assigrment, Tre Task 
Bulldge wil| type “DEFAULT ASSIGMNNENTSIH" ana aecegt the 
Gefault asSjqnmants [nN tne foljowing Syntax; 
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DEFAULT ASSIGNMENTS $45 <ASSIGNMENTD | 
<ASSIGUMENTS G45 SQEVICE UNIT TO™3" <LUNS>] 
<DEVICS UNIT> tie “DEVICE NAMED CUMNIT NUMBER; 

CDEVICE NAMED ts “LETTER> <LETTERD] 
CUN[T NUMBERD fle <UCTAL VALUED: 
<€LUNSD p42 <LIND <TERND| 
CLUND tte <DECIMAL VALUED: 
CTERMD> $13 <TCO/(KSO> KLUNS>); 


EXAMPLE} 
4 wh 351.2 
TT 45S 
T7136 


RESIDENT CODE 


‘Saar enanves ran 


Res[dent code defi{nas tne fila names of the object nodules 
tnat 3re to be {Inked ta form the user task {jrace, These 
Ooject mocyi{es will be |inked in tme order In which they are 
specified, The Task Buf fder wil}]] tyoe “reasicent ecodet" and - 
accent the rasidant code modules [n the follewlng syntax} 


“RESIDENT CODE t= <MODULE FILE NAMES> <TOD] 
CMODULE FILE NAMES? f3s CCMODULE NAMED/NULD | 
—SMODULE NAMED 14s <iAMED] 


GENERAL DESCRIPTION 


Tne TasK oulider is a singte task that contains a =I\neer 
wnlen relocates and [inns Cojact MNecules, relocates and 
Tinks references to Gj909] Common, ane Links to tne Kesltdant 
Reeentrant Cora LyJorary, The output of thHIS LIn«cr wii l -e 
Dilacad alrectliy on an allocated area on tne Spasifled Ils, 
Tne Task Suflider erogram wif] aljocate tne ASR’S and Systam 
Task Directory entry for each task, 


Instat! Ts a sInaie task that Instal|sa task [nto the system 
by making an entry Tn thea Systen Tase Olrectory (37T9), Tre 
task must Pave pean nrevioysly ocullt sy the TasK &Gylldaer and 
tne flia name must be the sama ag the task nana, 


DISK ALLOGATIO'S 


TASK INSTALLATION PASE 9 


Tha Task aullder allocates and zeroes conti|qusus space on 
tne shecifled disk for the rasldant code (exclualng Gloval 
Common, rerentrant |Torary and systen ifst's) of ai user 
task, If tna task |s Chackpojntabil[e The Task Builder will 
also allocate eae Ve OS | space to save the checknolnted tase 
Image, 


ASR ALLOCATION 


Feaq_ Be@Ptavauwuaerwra 


For aj! Privileged Tasks, use of the virtual address snace 
from 260705 thru 177777 CASRISASR7) [Ss presacefined, Address 
Space L437939"177777 ¢aSR7) Is manoeq Into the PQP@11 
Externaj Page, Address snace L9ZCH9=157777 (ASKS 4, 5 & A) 
Is mapned [nto the executive’s Space for access to Ssy3te2m 
tah|as, jlsts, pool, and executive subroutines, address 
space [6%3%3=4577777 (ASRS) Is vsea by tha Task to accass all. 
Momory (vila runet{[me.-alteration of [tS cotents), and jts 
contents are not préescrjdoed by Thea Task Bullcer,. | 


. AddrasS sgace 267999¢0=057777 ASRs By 1 & 2) +jcf Privileged 
 Tasks,- and al] memory address ‘Space of nonePrivijeged Tass 
Ts aljocated as fo|jows: 


Memory ‘§nace Is allocated for access to GLOBAL COMMONS from 
tna ton (Starting witr ASR7 for nonePrivilecad Tasks ®% AS$?2 
for Privileged tasks), One ASP fs used for 94ach 
GLOBAL CIHMON Cjess tnan 4%) usad, AGa}t]ona| ASKS are ysaa 
for GLCBAL COMMONS that area arraterp than 4K words, 


If references to the Resident Liorary apa mace, .suffictent 
ASRS to man [nto the entire |lbrary are allocates fram tre 
-.teop down, ” 


—ASRs for the Task axecution (including rout| es from a usar 
and system medium Ilbraryv) are allocated from tne hottom uno, 
ASR#S are completely satup fer the tasr’s execution av The 


Task Ruljider, The eniy cnangas th7t the syste n naads to 
maka at retuest time |s to set up tha hysisal lacaktlon 
oftne user caods, This [Ss determInea at axasutian hy the 


partition that |s spacifled wnen the task Is requested, 


RELOCATIO | PROCENURE 


Cearsavecasnwenewawe 


Aj|l task’s will] be relocated |[n pnrys{cal sore oy the 
Segmentation unlit (T3112, Tne user code and fre3z core must 
be cont{auous byt Tt may o8 anywhere [7 pninvsical cere, The | 
task? wi[||- aonear to start at Incatflon % and axnana yrwar its 
In Virtual memory tas spacifled In ASR Aljfocetion ), 4 sar 
task may pe any size to a maximum of 32x, Tne Global Sonmen 
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and yser |forary are {ncluded [n the s]ze of tne task and 
May not de cont{]gjguaus In virtual or physical memory, 


Mamory [s a{|ocatsd Tn the ‘tiene sequence} 

If the task [s a Pelv]ledgad Task ASR7 |s Inltallzed for tre 
Externa| Page, ASR#S 6,534 ara than usag as necessary to 
Pepmit access ta the sSysten jist!s and ferantrant 1/0 
Subroutines, | 


Gjoba|] Comtan Is ajflocated fiIrst since [t's S|[ze, focatton, 
and charatterl[sti]es are Known Sefore tne Doject Madu(es are 
TInkea, The Global Common foaces using the first froa, ASR 
CASR7 |f net a pet{ylsedged task); is ) 


After tne Gjopa| Common Is alfocatet the ‘Iser Task [5s 
“Tinked, Thea base of the usar tasx Starts just anove the 
Free Core and must be ohysicaily eentiquous, The User Taek 
and Free Cora always start from VJptuaj uw (A4S%F) and axnang 
Yowaras In Virtual memory, 

Tne Rementrant Position Indenerdent System Llorary (FORTRAN 
LIBRARY, ETC, ) |s the fast segqgarent to of linked, It wll 
use tne rer alnina ASR‘S, Tha Li[brary “f{l] ave read only 
or ivtleness to protect It against ace| dental destruction, 


~ SYSTEM TASK DIRECTORY ENTRY} 


* 
x Pee ®wveravnag herent ee Gg t* aH err ean 


The Task Bullder and Insta]{] wll] make an antey In the 


Systen Task (Cjrectory, This antry wlll Inciuce the Tesn 
Name, Pafault Partittlon, ang Yefault Prfor{[tv as -snecifjea 
tn tne sgvsten List’s Sec, The Task [nstallation- wll] 


Tasure that iene are mo eet) iets In Task “ames of ather 
Darameters of tna tas, 1 


